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TiiiHifi - mma ©i fi3@sram for the trs-m 

With TASHON (The Alternate Source's Monitor), memory may be 
examined/modified and machine language programs executed,, 
Machine language programs may be run in real time, single step or 
slow motion. Your Z-80 registers may be examined/modif led . They 
are continuously displayed in the upper right part of the screen. 
Three different memory dumps can be displayed on the left side of 
the screen while executing any TASMON command on the right side 
of the screen. Memory can be disassembled and routed to disk as 
an Editor/Assembler source file with labels generated for 
pertinent addresses. Machine language disk files can be read in 
and written out. 

mst aujng tasmmm 

There is a program on the distribution disk called INSTALL/CMD. 
Yoy will have to have this program on one of your disks in order 
to put XISMOM on your working TRSDOS 6.x backup* After you have 
used the INSTILL program once^ you can put it away. All other 
copies of TASM0N4 can be made by backing up the working master 
that you make with Iff STALL s 

Running IHSTALL/CHD is easy* Just make sure that the file 
SYS13/0BJ is on a copy of TRSDOS 6.x in drive and type INSTALL. 
As long as INSTALL is in a drive and SYS13/0BJ is on a TRSDOS 6.x 
disk in drive Q 9 all should go well, and after accessing drive 
for a while, INSTALL should say "TASMON overlay installed a w If 
something should go wrong f INSTALL will give an error message and 
abort back to TRSDOS Ready Correct the error and try again* 
REMEHBER - FURTHER BACKUPS CAN BE MADE FROM THE INSTALLED TRSDOS 
6«,ic DISK!!! It is also important to note that after INSTALL has 
run f SYS13/0BJ Mill no longer appear in your TRSDOS 6„x 
directory. That f s ok. INSTALL has actually put the code from 
SYS13/0BJ into SYS13/SYS and killed SYS13/0BJ* 

f : mmm ¥mm&m and conuentions 

All numbers displayed by TASMON are hex unless otherwise noted. 

In all examples given below f user inputs are underlined* 

The version of TASMON on the distributed diskette loads in memory 
from E000-FFFF with an entry point of LOGO. 

There is also a short machine language program entitled 
W TEST/CMD W Mhich is used in the sessions discussed at the end of 
this manual. 

For the most part, TASMON uses single letter commands and the 
ENTER key is not needed. The BREAK key may be depressed at any 
time to exit a command (except when writing/loading files to/from 



disk.) The LEFT ARROW does not backspace the cursor (unless 
entering a file name) so hit the BREAK key and re-enter the 
command if a mistake is made, 

When a four or two digit number is being input, any and all 
leading zeros must be entered. 

TASHON uses the DOS keyboard^ video and printer routines* If a 
key is held down, after a pause it will start repeating* The 
video display supports upper/lower case. TASMON displays the 

down-arrow key on the video display as a backslash which we have 
chosen to represent with an eielamation point (!). So* when you 

see an exclamation pointy think Sf down°arrow B w 

khen TASMOW is entered, the user's stack pointer is set at 03A0* 
The user nay change it as needed provided it does not interfere 
with TASMOMa 

The register display appears on the the right side of the screen 

in this foraat: 



GILL 01C9 




IX 5218 


If 


F29A 


IF 1 E23A 


BC« 


1530 


DE f 06F1 


HL f 


BC09 


AF 0044 


BC 


028A 


DE D98G 


HL 


3DF5 


SP 03A0 


PC 


8000 


-Z— P — 


(HL) FF 



The top line is the Ziiog disassembled mnemonic of the 
instruction pointed to by the PC register (8000 in this case). 
The .four digit hex number following each register pair is the 
current value of that register pair. The last line of the 
display is the status of the Z-80 flags (F register) . A Sf ° w 
indicates that the bit is cleared. The W FF W following n (HL) w is 
the value found at the current address of HL. In this case M FF M 
is at memory location 3DF5® Ail user inputs are done on the 
sixteen lines below the register display. 



TASMQN uses approximately 8K of memory. Some SVC f s are used to 
decrease progra® size. No RAM outside of TASMON is used with the 
exception of the symbol table when disassembling to disk ? the 
user's screen memory when using the KEEP SCREEN command , and the 
DOS overlay area*, One of the most commonly made errors with 
TASMON is using it to disassemble to disk and not reserving 
enough room in RAH for the symbol table. If you want to 
disassemble to disk, the best way is to make sure that TASMON 
resides from E000-FFFF and to set HIGH$ to DFFF* Before entering 
TASMON, type: 



MEMOM- ( - HIGHsX * DFFF '"- j 

at TRSDOS Ready, which will set HIGH* to DFFF® Then enter TA8II0N 

by typing: 

TASM0N4 

at TRSDOS K*say. Finally, if TASMON4 isn't at E0O0-FFFF (it is, 
if you loaded it straight from our distribytion disk) then 
relocate it with the X command (described in detail in the 
command summary . ) 

msmm m memms tasmon 

For executing the program from disk, type the following from DOS: 
TASM0N4 

The Z-80 registers and the caret user prompt will be displayed. 

If TASMOM is exited for soiae rtason there are two Mays to reenter 
the monitor: 

1) Go to BASIC and type: 

DEFUSR = &HEOOO <EIff£H> {assuming that TASHOB! is at E000) 

where w E000 n is the hex starting address of yhere T1SM0M Mas 
located in memory. 

2) !IiMi a DOS system enter DEBUG and type: 

where ,f E000 tf is the hex starting address of where TASMON Has 
located in memory. 

When TASMON is reentered in this* wanner the yser's registers are 
not changed. However, any breakpoints that Mere set are cleared. 

The W E W or EXIT command Is used to iea^e TASMON. To execute this 

coamand enter: 

E <ENTER> 

The ENTER key n^eds lv ut preyed as a safety precaution to 

prevent exiting the monitor unexpectedly . 



f mmm mmmmm 

The following is a list of TASMOW 9 s commands and the format with 
which they are entered* 

ttipyisi §tias?ii§ 

The REPLACE command changes any of the Z-80 registers. To use 
the command press "R M f the first letter of the register pair to 
be changed (the second letter is also required for IX and IY) f 
and the new four digit register value. An apostrophe is typed 
after the register pair name if the secondary set is to be 
changed. The display will appear as follows: 



R HL 09AF 


set HL to 09AF 


I IF* 2044 


set AF 1 to 2044 



mom mmn& 

The Modify memory command allows the user to change the contents 
of RAM. To execute the command press "M", an w A n or ^H" (for 

modification to be in ASCII or hex mode) followed by the address 
to modify. If the ENTER key is depressed for the address to 
modify^ the current PC address is used for the starting 
modification address. 

The ASCII modification mode accepts single character ASCII values 
and places them in the addresses being modified. The only 
control code recognized is the carriage return. The hex mode 
puts two digit hex values into an address. The current contents 
of the modification address will be displayed in the formats 

ADDRESS ASCII HEX 

Mhere W ADDRESS M is the memory address being modified, ^ISCII 11 is 
the ASCII value of the byte at fS ADDRESS w (only displayed if the 
value is between 20-7F) and "HEX" is the hex value of the byte. 

To change the contents of ADDRESS, type in a new two digit hex 
value or one ASCII character depending on which modification mode 
was selected. The up arrow will leave the current address 
unmodified and move to the previous byte* The down arrow will 
move down to the next byte. To exit, hit the BREAK key. A 
typical display is: 

M H 7 07F C 43 AE Hex modify aode, address is 70?F f ASCII 
value"©? byte at that address is "C" f the hex value is 43 and the 

byte was changed to AE* 

7080 82 <UP ARRQ¥> Move up one byte 
707F AE <BREAK> Exit modify mode 



NEMOfnr mmm 

There are three memory duaps in TASMON: 

1) Hexadecimal duiap 

2) ASCII dump 

3) Disassembled dump 

Ml three dusaps are initiated by pressing the appropriate command 
key followed by a four digit hex walue where the dump ia to 
start. Pressing the EUTER key instead of the four digit starting 
value causes the dump t© begin at the current PC register,, The 
screen Mill elear and 15 lines of the dump Mill be displayed • 

Pressing the SPACE BAR at this point causes the next 23 lines to 
be displayed. The DOWN AiHOM is used to display the next line. 
Pressing the K - w key causes the display to move back in aeaory 23 
lines (B8H bytes with ASCII and Hex dumps f 23 instructions with 

disassembler) . Holding dowi any of these command keys will cause 
them to repeat. Pressing the BREAK key f as ali#ays t returns 
control to command lode. 



The hex dump will display the hexadecimal values of memory 
starting with the address entered . For example; 

H 5200 

Mill eause this type of display to appear on 23 liaes« 

5200 45 AF 20 OF C3 DD 00 ED 
5208 34 A8 FF FF 99 83 FA 00 

The 5200 is the address and 45 is located there, 5201 holds AF S 

etc . 



mm mmm 

The ASCII dump will display 20-7F values as the appropriate ASCII 
character* 111 other walues are displayed in hex . For examples 

A FQQC 

will eause this type of display on 23 lines: 
F00C T H E 00 03 B Y 



BiSi8SEMll£B ©Off P 

The Disassembled dump will display memory in Zilog mnemonics* 

This dump makes reading programs much easier. For example; 

D 0000 

will cause the screen to clear and fifteen lines like the 
following to appears 

0000 FE DI 

0001 AF XOft A 

0002 C37406 JP 0674 

Relative jump addresses are displayed giving their destination 
address (like an absolute jump) instead of a relative offset. 

Illegal instructions are disassembled with "DEFB h w as the 
instruction where w h w is the offending byte. For examples 

8000 CB DEFB CB 

8001 300? JR WC,800A 

BisassiPK^i mmm m printer 

The n P w or PRINT command is used to route disassembly to the 
printer* To run this command press w P n , the starting address of 
the dump and the ending address of the dump. The disassembly is 
also echoed on the screen. Pressing the BREAK key at any time 
will cause printing to stop. If this command is executed and the 
printer is not ready , control returns to TASMON with nothing 
printed . For eiample: 

P 0000 0QF0 Disassemble to the printer starting at 0000 
and ending at 00F0* 

msm mmmm &msmm m prswter 

Pressing the w » w key while TASMON is waiting for keyboard input 
(except Mhen a file name is being entered) will cause the current 
screen display to be sent to the printer. If the printer is not 
ready at the time the nsw is pressed , nothing is printed and 
control returns to TASMOio Graphics characters are printed as 
periods. 

stJH/stJiTftner nex muxs 

This command will either sum or subtract two four digit hex 
values . Press n S n and two values followed by a n + n for sum or a 
n - n for subtract. The second value is added to or subtracted 
from the first. For examples 



S 0100 8023 ± 8123 

n 1 I?52 5-lM Z EB0 ° 

J 

jo mmmm§m §w is in mmmf 

The find conunauci uin looa^t uo^uious in memory where from 1 to 
4 user specified rw^ oleli h**>. digits occur. 

To run the command press w F lf f the starting address of the search 
and from 1 to 4 two digit, >se£. ?.h bytes . If less than 4 bytes are 
input ? the ENTER key must be depressed to start the search * 
Pressing n F M followed by EifXER will find the nest occurence of 

the last search key entered. 

The idd'f^bo yrier« Mr- byiee tie* ~ i ound is printed after the 
command line. If no value is printed , there were no more 
occurences of the search key in memory. For examples 

I 00Q0 |F 54 <ENTER> 4176 

Find where AF 54 reside--; in memory starting at 0000. First 

occurence was at 4176. 

F <£ NTER> 87FE 

Find next occurence of AF 54. Found to be at 87FE* 
F <ENTER> 

Ho value '/as printed so there were no more occurences. 

NOTE: The FIND command will always locate at least one occurence 
of the search key since the search key is stored in TASM0N* 

mm <& IHL6SS. &? MiEMOfW 

The n Z n or ZERO MEMORY command is used to set a- block of memory 

to some value. To execute ZERO MEMORY, press the P Z" key, a 

starting address , an ending address and a two digit hex value to 
be written into hie block. For example: 

1 IS^Jl F05Q 54 will set memory from F000 through F050 to 54 . 
1 F00 J050 00 will set memory from F000 through F050 to 00 . 

sup m emm yp me instruction 

To move the user's PC register to the next instruction without 
executing the cur-rent instruction press the RIGHT ARROW key. To 
move back to the previous i at -uooj on press the LEFT ARROW key* 



These commands allow an instruction to be easily repeated or 

skipped. For examole: 

If the user's PC register holds 8000 and the following code is in 

memory : 



7FFD 


2110F0 


LD 


HL ? F010 


8000 


110000 


LD 


DE,0000 


8003 


C38392 


JP 


9283 



Pressing the LEFT ARROW would move the PC register back one 
instruction or to 7FFD. Pressing the RIGHT ARROW would skip the 
instruction at 8000 and move PC to 8003. 



This command is undefined by TASM0N. It allows the user to 
define a routine to be executed by pressing the "U" key. If the 
"U" key is pressed without a user routine present nothing 
happens. To put a user routine in place, TASMON must be changed 
via the MODIFY MEMORY command so it will jump to the routine. 
The first step is to find where in memory to modify. TASMON 
checks for commands with the following type of code: 

CP MJ» m 

.1? Z, ADDRESS II 

To patch in a user routine the address at "ADDRESS" must be 

changed to the entry address of the user's routine. To find jfl 

where to modify enter the following, replacing the "E000" with U 

the starting address of your working copy of TASMON: 

F E0Q0 FL 55 CA <ENTER> E085 |[| 

The FIND command just found the first occurence of the menu 

select routine for the "U" key. The E000 address should be 11 

substituted with the starting address of TASMON (E000 in this « 

case). The FE 55 is a "CP » U ' " Z-80 instruction, and the CA is 

the first byte of the W JP Z f ADDRESS" instruction. 

To patch the user routine in place, MODIFY MEMORY in hex at three 
plus the address returned by FIND (this is the jump address). 
iNow type in the entry address of the user routine in Z-80 format 
(LSB first, MSB last) . 

The patched version of TASMON can be written to disk. Refer to 
the WRITE command discussed below for instructions on how to do 
so . 

To return from the user routine to TASMON simply do a Z-80 "RET" 
instruction (assuming the stack pointer has not changed). 



The USER function will be supported by various routines in the 
future . 

CLEAR SCREE! 

The clear screen command will clear the video display and 
redisplay the Z-80 registers* To execute this command press the 
SHIFT-CLEAR key* 

RELOCATE AiO HOUE MEMORY 

The RELOCATE command allows a machine language program to be 
moved from one location to another. All necessary jumps and 
loads within the range of relocation are changed . This command 
can be used to move TASMON from one location to another . 
RELOCATE can move many other machine language programs to new 
execution addresses® 

To RELOCATE memory, press an n X n followed by the starting point 
of the move, the ending point of the move and the starting 
address of where the code is to be moved to. RELOCATION takes 
about 3 seconds per 4K of memory moved. 

Suppose a program was loaded in memory from 8000 to 9FFF and we 
want to move it to E000 to FFFF„ The command flow would go like 
this: 

X 8000 9FFF EQQQ RELOCATE from 8000 to 9FFF and move it to E000 

NOTE: The RELOCATE command will function correctly if code is 
overlapped* However, it will not allow TASMON to be overlapped 
while relocating* 

For example, if a program resides from 8000 to 9FFF and is 
relocated to a new starting address of 9000, the relocated code 
will reside from 9000=>AFFF B The relocated version overlaps the 
origin memory block of 8000 to 9FFF* This type of relocation 
will work with all programs except TASMONo 

A problem can occur when relocating,, For example* suppose the 
following code was in memory: 

8000 210080 LD BC.8000H 
8003 CD6000 CALL STALL 

Suppose we relocated memory from 6000 through 80FF to E000* The 
code at E000 would appear as follows: 

E000 2100E0 LD BC,0E000H 
E003 CD6000 CALL STALL 
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If 8000 was a pointer to a text message, the change from 8000 to 
E000 would be correct, but in this case the 8000 was a stall 
value since the call to STALL is a delay routine* The change 
from 8000 to E000 in effect doubles this stall. 

There are other occurences of this type e Another is when a 
register pair is loaded with, for example, the number of bytes to 
read from a disk file. If this number is changed the results 
could be disastrous. 

Even with these two potential problems, RELOCATE does function 
with most programs . 

mmi A BLOCK' OF MEMORY • 

To HOVE a block of memory from one location to another use the 
"Y" commando The command parameters are the same as for the 
RELOCATE (starting address, ending address and new starting 
address) commando This command simply copies memory from one 
location to another. The move routine is "smart 18 enough to allow 
code to overlap. For examples 

1 60QQ 6035 5000 

Move memory from 6000 through to 6035 to 5000* 

lifOT/OOTPUT 

The author of TASMQN chose to make the program's disk I/O file 
oriented rather than sector oriented as most other monitors. 
This allows a disk file to be loaded into RAM and then written 
back out, 

mew a file 

The VIEW command is similiar to the LOAD command in that it 
returns the starting, ending and transfer addresses of a disk 
file, except the VIEW command-does not load the file into memory. 

To execute the VIEW command press "V". A file name must be 
entered* For example: 

V 

CHESS/CMP 

7000 8FA3 7535 

The file "CHESS/CMD n was VIEWed from disk* The starting, ending 
and transfer addresses were found to be 7000, 8FA3 and 7535 
respectively. Memory from 7000 to 8FA3 was not modified however, 



r 
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NOTE: it is good practice to VIEW a file before LOADing it to 
verify the module will not load over TASMON, 

LOAD A FILE 

To LOAD a CMD file from disk press the »'L" key, the ENTER key or 
a load offset, and a filename. For examples 

L <ENTER> Load the file TEST/CMD into memory from disk 
TE5T7TffF ° 

After a module is loaded 9 the starting f ending and transfer 
addresses are displayed in that order. A typical load display 
would be: 

L <ENTER> 

MYPROG/CMD <ENTER> 
F000 F035 F010 

The starting address of the program is F000 s the ending address 
is F035 and the transfer address is F010„ 

UHtTE A FILE 

To write a file out press M W 9 " (for WRITE) followed by the 
starting, ending and entry addresses. Lastly? the filename is 
entered. When entering a file name the SHIFT BACKSPACE does not 
function. The BACKSPACE must be repeatedly pressed or held down 
to get to the beginning of the line. 

If the above block move example was to be written to disk the 
following would be keyed in: 

W 6350 6C08 6BFB 
FILE/CMP 

Write to disk starting at 6350, ending at 6C08 with an entry of 
6BFB, Use the file name ?S FILE/CMD ! » 

DISASSEMBLE TO DISK 

The OUTPUT command will disassemble to disk as an 
Editor/Assembler source file. The code sent to disk is also 
echoed on the screen. To execute this command press the M 0" key 
(for OUTPUT) and the starting, ending and transfer addresses of 
the dump. A filename is also entered. 

A symbol table is generated by TASMON to ease the reading of the 
dump. The symbols are created for all 16 bit addresses between 
the starting and ending addresses specified. This table starts 
at the high memory pointer and builds downward in memory. If 



12 

there is a program running in high memory make sure this pointer 
is set to such a value that the program will be protected . If 
TASMON is moved to high memory there will be about 100 bytes free 
for the symbol table. There are basically two ways to increase 
the symbol table sizes 

1) Move TASMON lower in memory. 

2) Set HIGH$ to the address immediately below TASMON* 

Of the two, the second is usually the preferred technique,, 

The symbol table uses two bytes per label. If large amounts of 
memory are being disassembled^ there could be a pause of several 
seconds while the symbol table is being generated . 

The starting address given will be used as the address of the ORG 
pseudo-op* The ending address is simply where output will halt. 
The transfer address is the address placed on the EMD pseudo-op. 

Any text messages dumped to disk will be sent as Z-80 
instructions* Therefore^ some work may be required by the user 
to generate the proper source code in this case. 

The source is written out with line numbers of 00000* Therefore* 
the first command executed from Editor/Assembler after the source 
has been loaded in would be RENUMBER (i.e. N 100,10). 

The command format goes as follows : 

F0Q0 FQ35 FQ10 
TEST/ASH 



Output to disk starting at F000, ending at 
F035 s and entry address of F010* 
Use the file name "TEST/ASM" 



The symbols TASMON generates are simply the address in question 
preceeded by a "Z ,f . For example f a typical label would be: 



Z0046H CALL 



Z002BH 



Bad symbols can be generated in some instances where text 
messages and stall or counter values are used. For example^ if 
the following code was in memory: 

8000 21 

8001 00 

8002 1F 

8003 10 

8004 FD 

The bytes at 8000 and 8001 could be the last two bytes of a text 
message. The instruction at 8002 is a RRA* The instruction at 
8003 is a DJNZ and the offset at 8004 refers back to 8002. 
However , when this code is disassembled out it would appear as 
follows: 
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LD HL.1F00H 
DJfaZ Z8002H 

The symbol ?t Z80Q2H' f is never defined since the instruction at 
8002 was incorrectly disassembled as the most significant byte of 
the "LD HL, nn" instruction at 8000* The solution for this 
problem is to change the symbol ?9 Z8002H" to the address M 8002H" S 

The source code will still appear incorrect but reassembling the 
source will give correct results. 

^OTE: if a disk error ever occurs with TASMON,, an error message 
and the TRSDOS error code (in hex) is printed. Refer to appendix 
A at the end of this manual for a list of error messages. 

breakpoints 

TASMON gives the user control over 9 breakpoints* A breakpoint 
allows a machine language program to be stopped at a 
predetermined spot and transfer control back to TASMON* For 
example, if a breakpoint was set at 8000 and the user f s program 
executed the instruction at this address^ control would be 
returned to TASMON* 

Breakpoints are labeled 1-9- A three byte breakpoint (CALL nn) 
is used to intercept the user's program. 

One unique feature of TASMON is that the number of times a 
breakpoint is executed before halting may be set for each 
breakpoint . 

SET mm DISPLAY BREAKPOINTS 

To set a breakpoint press "B" followed by the breakpoint number 

(1-9) and a four digit value. Breakpoints may be placed anywhere 

in memory* TASMON sets a breakpoint to 0000 in order to clear 
it. 

To display the breakpoints press f? B f? and hit ENTER* Three rows 
of three sets of 4 and 2 digit hex values will be printed^ These 
correspond to the values and number of executions for breakpoints 
1, 2 S 3» etc. For example: 

B 8 809E sets breakpoint 8 to 809E 

B <ENTER > displays all breakpoints 
7lF3 01 0000 01 0000 01 
7802 01 0000 01 0000 01 
0000 01 809E 18 0000 01 

Breakpoint 1 is set at 41F3 and the execution number is 1, 
Breakpoint 4 is set at 7802 and the execution number is 1, 



Breakpoint 8 is set at 809E 
all others are cleared. 



and the execution number is 18H ? and 



NOIL: Care should be taken so that breakpoints do not overlap. 
For example, breakpoints must differ in address by at least three 
to function correctly. Suppose a breakpoint is set at 8000 and 
another at 8001 . They will not function correctly since the 
three byte breakpoints will overlap (8000-8002 and 8001-8003): 





brkpnt 1 


Brkpnt 


8000 


\** H. L* La 




8001 


S* K% l-J 


CALL 


8002 


msb 


lsb 


8003 




msb 



kp^ber of executions before break 

The "N" or "Number of executions before break" command allows 
setting the number of times a breakpoint is executed before the 
breakpoint is acknowledged. The default value is 01. This means 
execution will halt if the breakpoint is executed 1 time. 

The formats of the command are: 

H 22 22 Set th e number of executions for breakpoint n to "h" (a 
value from 00-FF where 00 is 256 decimal). 

2i L Set the number of executions for all breakpoints to 01 

(or the normal number of executions). 

H <ENTE R> Set all breakpoints back to their set values. This 
value will be 01 unless changed by the "N n h" command. 

The number of executions value is used only by the TRACE and GO 
commands (both discussed below), not by the single steppers. The 
value is decremented each time the breakpoint is executed. When 
this value reaches zero, execution halts and all execution 
numbers are reset to their original values (01 unless changed by 
the "N n h" command). The M N <ENThR>" command will also reset 
the values. 

host users probably will not use this command. If the execution 
number is left at 01, breakpoints will function as with any other 
monitor program. 



To clear a single breakpoint press "C" followed by the breakpoint 
number (1-9). To clear all breakpoints type "C" followed by 
ENTER. For example: 



C 1 



will clear breakpoint 1. 
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C <KHT£R> will clear all breakpoints. 

There are two types of step commands in TASMON, manual and 

automatic. Each will start at the location pointed to by the 
user's PC register and return control to TASMON and display the 
registers. The PC register should contain the execute address of 
the user's program* 



There are two types of single steppers in TASMON: 

1) step next instruction with CALLs executed in full. 

2) step next instruction with CALLs stepped through. 

The first type of single stepper will execute one instruction 
with CALLs executed in one step. To execute this command hit the 
DOWN ARROW key. The user's registers will be redisplayed upon 
return to TASMON. If a breakpoint is set within a CALL executed 
with this stepper, the CALL will be executed only up to the point 
of the break. 

The second type of single stepper will execute one instruction 
with CALLs stepped through one instruction at a time. This 
command is executed by pressing the "I f? key. 

gSMGLE STEPPING RESTARTS 

The Z-80 "RST" command is a special single byte CALL. RESTARTS 
may be "stepped through" or "executed in full." The DOWN ARROW 
and "I" keys" are still used to step restarts, except the M J" or 
JUMP THROUGH RESTARTS command is used to determine how they are 
handled. If pressing the "J" key displays a DOWN ARROW, restarts 
will be executed in full. If pressing the "J" key displays an 
"I", restarts will be stepped through. For example. 

j_ I Step through restarts mode is on 
7 ! Execute restarts in full mode is on 

The status of restart stepping has no effect on how CALLs are 
handled. For example, CALLs can be stepped through while 
restarts are executed in full. 

t m^m mzm&mm 

The Trace command will continuously single step the user's 
program and redisplay his registers. To invoke this command 
press the "T 11 key. Next, enter the type of stepping desired. A 
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DOWN ARROW is used to execute CALLs in full and an "I" for step 
through CALLs. For example: 

T I starts TRACE with calls stepped through 

The step rate can be varied from about 2 seconds per instruction 
to 15 instructions per second by pressing the 0-7 keys while 
TRACE is executing (7 is the fastest step rate). Every time 
TRACE is entered the step rate is reset to one instruction per 
second . 

Trace execution is halted by one of four ways: 

1) One of the 9 user breakpoints is hit and the execution number 

is decremented to zero. 

2) The BREAK key is depressed (control returns to command mode). 

3) The SPACE BAR is depressed (execution pauses until the SPACE 
BAR is depressed again). 

4) A "RET" instruction was executed while the "RETURN 
BREAKPOINT" option was on. 

At times the user starts stepping through a CALL. When all the 
information needed is found, all the user wants to do is get out 
of the call. The "RETURN BREAKPOINT" option is a way of getting 
out of the CALL quickly. By pressing the M R" key while tracing, 
the "RETURN BREAKPOINT" option is turned on. When this option is 
on, the next Z~80 "RET" or "RET cc" where the condition was met 
will halt TRACE execution. This option is like putting a 
"floating" breakpoint on "RET" instructions. The only way to 
turn this option off is to exit and reenter TRACE. 



"" , 



The GO command will start the user's program at full speed. 

The only way to halt the user's program is for a breakpoint to be 
executed until the execution number is decremented to zero. 

To use the GO command, press a "G" followed by either a hex value 
where execution is to start or the ENTER key (execution starts at 
the user's PC register). For example: 

— kOQO will start execution at 8000 

G < E N T E R > will start execution at the PC register. 

To continue on from a breakpoint with GO do either of the 

following : 



1) Single step over the instruction where the break occured. 

2) Clear the breakpoint where the break occured then use the GO 
command to continue on. 



IT 

One of these two -steps is required sinee GOing at a breakpoint 
address simply returns control to TASMOM with none of the user f s 
program executed. Single stepping over the instruction at the 
break address then allows the GO command to continue on normally 
until the n<?zt breakpoint is executed. 

NOTE: More than one instruction may need to be single stepped 
sinee a breakpoint uses three bytes. If GO execution is resumed 
in the middle of a breakpoint results can be unpredictable. 

If the number of eiecutions for a breakpoint is set greater than 
one s the GO eosaand will execute part of the user's program at 
full speed and single step part of it (single step enough of it 
to eake sure execution does not resume in the middle of a 
breakpoint). The BREAK key may be depressed to halt execution 
while single stepping if desired. 

! 
NOTE: TASMON does not allow an illegal Z-80 opcode to be single 
stepped or traced. Bad code is disassembled as "DEFB h. n To run 
this type of code $ a breakpoint must be set after the instruction 
and the GO command used to step it if so desired . 

mi? fWEm 

TASHOi uses columns 56 to 72 for its displays. However , some 
user programs may also use these locations. The "K" or "KEEP 
SCREEN" command may be used to save the screen before TASMON 
affects it. When the K KEEP SCREEN" option is enabled , the user's 
last screen will be redisplayed before single stepping, tracing 
or GOing . On return from one of the stepping commands the screen 
will be resaved. There are four formats of the W K M command as 
follows: 



1) K start address 

2) I TeuWU>~~~^ 

3) X T~~ 



save screen at "start address* 1 
display user's screen 
turn KEEP SCREEN on 
turn KEEP SCREEN off 



The first option, "K start address", is used to initialize the 

KEEP SCREE?! command . The four digit value "start address" is the 

starting address of a 20*18 byte buffer in memory where the user's 
screen is to be saved. When the location is entered the screen 

memory is set to a clear screen of 2048 spaces (20H) . The ASCII 

option of the MODIFY MEMORY command may be used to set the screen 
to some initial condition. 

The second option, W K <EWTER>% will bring the user's saved 
screen back to the video display and leave it there as long as 
the ENTER key is held down. This option allows for a quick 

review of the user's display,, 
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The third option, ?? K I F % is user! to turn the KEEP SCREEN option 

on. Whenever a program Is stepped with this option on 9 the 
user's screen Hill be redisplayed and saved continuously. TASMON 

will not affect the user f s screen at alia 

The forth option, "K N w , is used to turn the KEEP SCREEN option 
off. The current saved screen is not changed by turning the 
command off. 

The screen buffer aay be cleared by the n K start address" option 
or the ZERO MEMORY command. Example inputs are: 

K DCOO Set user's screen buffer at DCGO-FFFF 

ancTeTear the buffer (make it all 

spaces) . 

K ^EMTER> Display the current saved screen, 

K Y Turn the KEEP SCREEN command on . 

K N Turn the KEEP SCREEN command off. 



A commented list Jag of the source code is available from The 
Alternate Source for $30. The 

address is; 

The Alternate' Source 
70 1 ! ?J ffl l/r.-HiiOvl van la Ave, 
Lansing, Mi. J*89°o 
(317) '»82-8270 

< - :. -:!•;< jviTTC v :?:s tmmtm ease 

A powerful feature of TASMON is that the BASIC interpreter 

written by Microsoft may be single stepped. 

This allows a BASIC program to be entered from the keyboard and 
RUM. TASMON will step through the routines of the BASIC 
interpreter to perform these tasks. 

The first step is to get BASIC and TASMON co-resident in memory. 

This can be done a few ways: 

Disk users can load TASMON from DOS and load BASIC by typing? 
L <ENTER> 

BASIC/CMD. BASIC 

Where AAAA, BBBB, and CCCC are the starting , ending, and 
execution addresses that TASMON reports for BASIC/CMD. 
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The next step is to set a breakpoint at 5920. This the address 
of the BASIC command mode. If this breakpoint is not set, any 
error from BASIC sueh as a SYNTAX or MISSING OPERAND error will 
cause TASMON to be exited • 

If TASMON is ever exited in this manner simply re-enter the 
monitor by typing! 

> D£F USE s &HEQQQ <ENTER> 
> X s USR(Q) <ENTER> 

The state of the Z-80 registers will remain unchanged . 

Therefore, stepping can continue from where TASMON was exited * 

RESTARTS must be set to ^execute in full 1 * mode. Press the "J* 1 
key until this mode is enabled. The "execute in full 1 ' mode is on 
when an n l n is displayed after the "J 11 pressed by the user. 

Now BASIC can be either single stepped via the DOWN ARROW key or 
"I" key or TRACE mode. 

If TRACE mode is selected with CALLs executed in full and the "T 11 
speed option is selected (fastest TRACE step rate), BASIC will 
operate about 5000 times slower than normal. 

If CALLs are stepped through^ keyboard characters must be held 
down until the keyboard driver routine used by BASIC scans 
through them. After this there is a significant stall to 
eliminate keybounce* For these reasons CALLs executed in full is 
recommended for stepping BASIC 

The re-entry address of BASIC is 5920. Modify the PC register to 
this address before stepping BASIC as follows 

R PC 5920 

After TASMON has been patched in, BASIC will function normally. 

Some BASIC commands will not function correctly. For example^ 
none of the disk input/output commands will function correctly. 

The breakpoint at 5920 will be executed each time the ENTER key 
is pressed. This may be an irritation^ but the breakpoint is 
required or stepping BASIC will not function correctly. 

When the breakpoint at 5920 is executed, simply continue tracing 
or single stepping by pressing the appropriate command key(s). 
For example, to continue with TRACE mode type: 

T I 

Pressing the BREAK key will exit BASIC and return to TASMON. To 
continue stepping BASIC S simply continue tracing or single 
stepping by pressing the appropriate command keys. 
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Refer to SESSION H for more information and an example of single 
stepping a BASIC program* 
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SftWPfcE sessions . , . . 

The following sample sessions are examples using TASMON's 
commands . 

SESSION 1 - RELOCATE TASMON 

The distributed version of TlSHOi loads from EOOO-FFFF with an 
entry point of E000* however f some owners of TASMON will 
probably want TASMOM to run at low memory or 3000-4FFF* T© do 
this enter the following commands? 

From DOS enter TASMON by typing: 

TASM0N4 

The Z-80 registers and user prompt will be displayed. 

Next use the RELOCATE command to move the program to memory 
starting at 3000. The format is: 

X EQOQ FFFF 3000 which relocates memory from E000-FFFF to 
memory starting at 3000. 

Now TASMOM resides at E000-FFFF and at 3000»4FFF* To save the 
low memory version to disk use the WRITE command. The format is : 

W 3000 4FFF 3000 
LTASMOM/CMD 

khich dumps memory from 3000-4FFF with a transfer address of 3000 
to disk with the file name "LTASM0i/CMD w . 

Whenever fl LTASM0N ls is typed in from DOS the low memory version of 
the program will be executed* 
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SESSION t - STEP AND TMfiCI A /CMO FILE 



The short program used in this example appears as follows J 

ELIMINATE INTERRUPTS 
HOME CURSOR CHAR 

DISPLAY A CHAR CODE 

DO SVC 

CLEAR TO EOF CHAR 

DISPLAY CODE 

DO SVC 

LOAD DE WITH *KI NAME 

SET UP SVC #82 

DO SVC 

GET RESULT IN DE 

POINT TO BUFFER 

CONVERT TO ASCII 

DO SVC 

POINT TO «KI MESSAGE 

DISPLAY IT 

LOAD DE WITH ^DO NAME 

SET UP SVC #82 

DO SVC 

GET RESULT IN DE 

POINT TO BUFFER 

CONVERT TO ASCII 

DO SVC 

POINT TO «DO MESSAGE 

DISPLAY IT 

LOAD DE WITH *PR NAME 

SET UP FOR SVC #82 
DO SVC 

GET RESULT IN DE 
POINT TO BUFFER 
CONVERT TO ASCII 
DO SVC 

POINT TO *PR MESSAGE 
DISPLAY IT 
EXIT TO TRSDOS 
DO SVC - BYE, BYE! 
GET THE CHAR AT (HL) 
BUMP POINTER 
ZERO BYTE? 
RETURN IF SO 
PUT CHAR IN C 
DISPLAY A CHARACTER 
DO SVC 

GO BACK TO LOOP 
DCB resides at: ? 



ooi no 


Dl 






,10 1 1C 


LD 


C s 2d 




00120 


LL 


A s 2 




00130 


RST 


28h 




00140 


LD 


C,31 




oc 150 


LD 


k 9 2 




00160 


RST 


28H 




00 170 


LD 


E , • K • 




00160 


LD 


D f 8 I B 




00190 


LD 


A ,82 
28H 




00200 


RST 




00210 


EX 


DE.HL 




00220 


LD 


HL f BUFF 




00230 


LD 


A, 99 




0024 


RST 


28H 




00250 


LD 


HL, KIMSG 




00260 


CALL 


DISPL 




00270 


LD 


E , ' D • 




00280 


LD 


D , » ' 




00290 


LD 


A ,82 




00300 


RST 


28H 




00310 


EX 


DE,hL 




00320 


LD 


HL, BUFF2 




00330 


LD 


A f 99 




00340 


RST 


28H 




00350 


LD 


HL,DOMSG 




00360 


CALL 


DISPL 




00370 


LD 


E , ' P ' 




00380 


LD 


D, , R» 




00390 


LD 


A ? 82 




oonoo 


RST 


28H 




00410 


EX 


DE f HL 




00420 


LD 


HL.BUFF3 




00430 


LD 


A ? 99 




00440 


RST 


28H 




00450 


LD 


HL,PRhSG 




00460 


CALL 


DISPL 




00470 


LD 


A,22 




00480 


RST 


28H 




00490 


DISPL LD 


A,(HL) 




00500 


INC 


HL 




00510 


OR 


A 




00520 


RET 


Z 




00530 


LD 


C ? A 




00540 


LD 


A, 2 




00550 


RST 


28h 




00560 


JR 


DISPL 




00570 


KIMSG DEFM 


' Tne keyboar 


d 


00580 


bUFF DEFM 


s xxxxH s 





I: 
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00590 DEFH OOODH 

00600 DOMSG DEFM 9 The video DCB resides at: f 

00610 BHFF2 DEFM f xxxxH' 

00620 DEFW OOODH 

00630 PRHSG DEFH ? The printer DCB resides at: * 

00640 BUFF3 DEFM 'xxxxH 8 
00650 DEFW OOODH 
00660 END 3H00H 

The purpose of this program is to find the Device Control Blocks 
for the major devices (keyboard* video, and printer) and display 
them on the screen. For this session TASMON is assumed to be in 
memory from E000-FFFF and the short program given above is saved 
on disk under the file name M TEST/CMD» a The distributed copy of 
TASMON has both of these files on the master diskette with the 
indicated load addresses. 

The first step is to load the file into memory . The LOAD command 
is used for this by keying in: 

k <E N ^ ER> 
ThST/CMD 
1TO0~30BB 3000 

The file Bt TEST/CMD 81 loaded from 3000-30BB with an entry point of 
3000. 

e first time through the program we will simply single step it. 



Th 



The first step is to load the PC register with the starting 
aadress of the program or 3000. Use the REPLACE command to do 
this: 

R PC 3000 

To aid in viewing the program, disassemble the program to the 
screen. This is done by entering: 

D 3000 

The first 23 instructions of the program will be displayed on the 
left sine of the screen. Now hit the BREAK key to get back to 
command mode. The disassembled code and the Z-80 registers will 
be displayed. The screen should appear as follows: 



3000 


F3 


DI 




3001 


0E1C 


LD 


C 9 1C 


3003 


3E02 


LD 


A,02 


3005 


EF 


RST 


28 


3006 


0E1F 


LD 


C, 1F 


3008 


3E02 


LD 


A S Q2 


300A 


EF 


RST 


28H 


300b 


1649 


LD 


D f 49 


300D 


1E4B 


LD 


E 5 4B 



DI 








IX 


4C41 


IY 


094C 


AF' 


4B43 


BC 


4353 


DE' 


AA52 


HL 1 


0B0A 


AF 


00FF 


BC 


4C44 


DE 


4C48 


HL 


A070 


SP 


41E4 


PC 


5F00 


SZ1H1PNC 


(HL) 4C 
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300F 3E.52 


LD 


A, 52 


3011 EF 


RST 


28 


3012 EB 


EX 


DE f HL 


3013 217130 


LD 


HL 8 3071 


3016 3E63 


LD 


A, 63 


3018 EF 


RST 


28H 


3019 215*430 


LD 


HL.3054 


301C CMA30 


CALL 


304A 


301F 1EM4 


LD 


E 9 m . 


3021 164F 


LD 


D ? 4F 


3023 3E52 


LD 


A 9 52 


3025 EF 


RST • 


28H 


3026 EB 


EX 


DE,HL 


3027 219230 


LD 


HL 9 3092 



Notice that the labels used In the source code have been changed 
to actual addresses^ and the text message appears as Z-80 

instructions',, 

hit the BREAK key to exit the DISASSEMBLE mode and reenter 
TASHON's command mode* 

To single step the instruction at the PC register or 3000 (which 
is a DI) hit the DOWN ARE0H or M I" key. The PC equals 3001 and 
the instruction at 3001 (or PC) Is LD C f 1C. 

Single step this instruction* The C register will hold 1C or an 
ASCII "HOME CURSOR". PC Mill now be 3003® The next instruction 
is "LD A,02 w e Single step PC again* A equals 02 or the SVC code 
to display a character. PC now holds 3005. The instruction there 
is a RST 28H. This instruction is the SVC, or Supervisor Call* 
Remember the W J W key? Press it until you see a backslash* This 
is to make sure that the RST will be executed in full. Single 
stepping through it could be disastrous for reasons that are 
explained in the Technical Appendix. In the meantime^ execute 
this instruction in full. 

The next instruction is LD C,1F which is the ASCII code to clear 
to the end of the frame (screen). 

The next instruction is LD A, 02. Again, this is the SVC code to 
display a character on the screen. Step this instruction also. 

The next instruction is the RST 28H. Yet again, this is the 
actual Supervisor Call instruction. Execute it by hitting either 
"I" or "I". 

The screen should have cleared, TASMON's register display will 
still be intact, since TASMON updates the register display 
whenever necessary. 

The current instruction should be "LD E,J*B" . You can verify this 
by looking above TASM0N f s register display. The LD E,4B should 
appear there. Single step this instruction. 
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Tne next instruction is LD D,49» Single step this instruction 
also. 

The next instruction is LD A f 52 9 This is the code for the SVC to 
find the DCB of the device named in DE (which at the moment is 
device *M, or the keyboard* 49H is a "K" and 4BH is an "I". 

The next instruction is the SVC to find the DCB* Execute it in 
: ull. 

HL should now contain the DCB address. The next instruction, EX 
DE,HL should move the address to the DE register pair so that we 
can convert the hex value to an ASCII string with the next SVC . 
Step the EX DE.HL. 

Now we see LD HL ? 30?1 which points HL to the buffer where we want 
to store the result of the ASCII conversion of DE . Step the 
instruc tion . 

Next we have LD A ? 63 which is the code for the hex to ASCII 
convert SVC. Step this. 

Here is the SVC, Execute it in full. 

Just to see if it worked ? type: 

A 3071 <ENTER> 

You should see the string of characters that represents the 

number that was in the HL register pair after the third SVC (the 

one that found the address in the first place.) If so, all is 
well. 

Hit <BR£AK> to get back to TASMON s s command mode. The next 
instruction is LD HL,3054. This points HL to the beginning of a 
message that preceedes the actual value of the address. Step 
this instruction. 

Next we have a CALL 304A, For the moment, let ! s take a clo^e 
look at this subroutine by pressing the "I" key to single s 

Notice that the PC is now at 304A, which is the address that ,^ 
CALLed. The instruction is LD A,(HL). Remember that HL is 
pointing to a message. Step this instruction. 

Now we see an INC HL instruction. This simply moves HL to the 
next character in the string. Step this one s too. 

Now we have an OR k. ORing A against itself like this is an easy 
way to see if A contains a zero. Step this instruction. 
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Look at the register display* The line of dashes and letters has 
been changing throughout this session, but only now is it really 
important* because the instruction here is RET Z. Is there a Z 
in the line of dashes? No, there isn't* That's because the 
contents of A (the first character of the message, in other 
words) is not equal to zero* Step this instructions 

It didn't return, did it? The current instruction is LD C,A B 
This is necessary because the SVC to display a character needs 

the character to be in the C register. Step this instruction. 

The next one is the (by now) familiar LD A, 02 instruction f> which 
is the command to display a character* Step this instruction* 

Now we have the SVC. Execute this in full. An uppercase n T n 
should appear in the upper left hand corner of the screen. 

The next Instruction is a JR 304A* Step this. 

We're back at the beginning of the subroutine! We already know 
what the subroutine looks like, so let s s trace. Type T l_ to 
start tracing* 

We want the tracing to stop as soon as the subroutine is done, so 

press the n R" key. This tells TASMON that as soon as it is about 

to execute a RET Instruction to stop tracing and go back to 
command mode. 

The tracing can be sped up by pressing a key from 1 to 7 if the 
trace is too slow for your taste. 

The tracing will stop with the current instruction being the RET 
Z that we saw earlier. The fact that TASMON has stopped tracing 
means that the condition has been met, and the RET is about to be 
executed . Step through the RET. 

The next instruction is LD E,44. This is the first LD in the 
next device search setup. We now know how TEST/CMD goes about 
the setup process, so let's let the program do the work now and 
just look at the results. 

The best way to do this is with a breakpoint. Before setting a 
breakpoint, though, it helps to know w here to set the br ^point. 
So, type D <ENTER> to start disassembling to the screen from the 
current instruction. 

You should see some instructions that are identical to the ones 
that we just executed, except that the LD's to E and D are 
different and the buffer addresses are different. At address 
3033 there is another set of practically identical i nsfcr ^;tions 8 
Since the instructions seem to be following a logical pattern 
(which, indeed, they are) press <BREAK> to return to the command 
mode and type: 
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I .1 3033 

which will set breakpoint #1 at 3033H. The current instruction 
is still LD E t M and the PC contains 301F. Now type: 

G <ENTER> 

Practically instantly you should have seen the computer print a 
message telling you where the video DCB is. That ? s because when 
you typed in the G command TASMON actually gave control to the 
TEST/CMD program briefly, allowing it to run at full speed. It 
then ran into the breakpoint at 3033, which is what the PC should 
contain now. The current instruction should be LD E ? 50 e 

Now we want to remove the breakpoint^ since we won't be using it 
again. Type: 

c j_ 

This will remove breakpoint #1. Remember that you can remove ALL 
breakpoints by typing: 

C <ENTER> 

Now we just want to finish executing the program 8 so type: 
G <ENTER> 

which is what you typed after you set the breakpoint* The 
program will take over again^ but since there is no breakpoint 
for it to hit, it will continue running and return you to TRSDOS 
Ready. You will have to reload TASMON to continue. 
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SESSioi 3 - oisftssEMiLE program to disk 

The n s? or OUTPUT command is used to accomplish this task,, 

The first step is to load ' ! TcST/CMD» into memory by entering: 

L <ENTER> 
TLS77CMET 
3000 30BB 3000 

Next, enter the OUTPUT command as follows: 

3000 30BB 3000 
TEST/ASM 

The disassembly will be written out to aisk with the file name 
TEST/ASM starting at 3000 and ending at 30BB with a transfer 
address of 3000. Now exit TASM0N by keying in: 

E <ENTER> 

The system will reenter DOS. Suppose you have an 
Editor/Assembler. Enter the E/A by typing its file name from 
DOS. 

Next ? load TEST/ASM with the "LD" command of Ldi tor/Assembler (or 
similiar command if using a different E/A). As stated previously 
under the explanation of the OUPUT command, the first command to 
enter is a RENUHBER command (assuming that your E/A requires line 
numbers - ALE doesn't, ZEUS renumbers automatically, and others 
work still differently.) TA5M0N writes cut the file with line 
numbers of 00000 so this command may be required . To do this 
enter; 

N 100, 10 nhieh renumbers the program in increments of 10 with 
a starting line number of 100, assuming that you are using Radio 
Shack s s Editor/Assembler. 

The source listing should be: 



00100 


ORG 


3000H 


00110 


DI 




00120 


LD 


c 8 1CH 


00130 


LD 


A ? 02H 


00140 


RST 


28h 


00150 


LD 


C ? 1FH 


00160 


LD 


A,02h 


00170 


RST 


28H 


00180 


LD 


E, 4BH 


00190 


LD 


D,49h 


00200 


LD 


A,52H 


00210 


RST 


28H 


00220 


LX 


D E s H L 
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00230 

oozno 

00250 
00260 
00270 
00280 
00290 
00300 
00310 
00320 
00330 
00340 
00350 
00360 
00370 
00380 
00390 
00400 
00410 
00420 
00430 
00440 
00450 
00460 
00470 
00480 
00490 
00500 
00510 

00520 

00530 
005^0 
00550 
00560 
00570 
00580 
00590 
00600 
00610 
00620 
00630 
00640 
00650 
00660 
00670 
00680 
00690 
00700 
00710 
00720 
00730 
00740 
00750 
00760 



Z304AH 



Z3054H 



LD 


HL,Z3071H 


LD 


A ? 63H 


EST 


28H 


LD 


HL ? Z3054H 


CALL 


Z3041H 


LD 


E 9 44H 


LD 


D f 4FH 


LD 


A f 52H 


RSI 


28H 


EX 


DE»HL 


LD 


HL.Z3092H 


LD 


A 9 63H 


RST 


28H 


LD 


HL,Z3078H 


CALL 


Z304AH 


LD 


E S 50H 


LD 


D g 52H 


LD 


A,52H 


EST 


28H 


EX 


DE.HL 


LD 


HL.Z30B5H 


LD 


A ? 63H 


RST 


28H 


LD 


HL.Z3099H 


CALL 


Z304AH 


LD 


A, 16H 


RST 


28H 


LD 


A,(HL) 


IMC 


HL 


OH 


A 


RET 


Z 


LD 


C,A 


LD 


A f 02H 


1ST 


28H 


JR 


Z304AH 


LD 


D,H 


LD 


L,B 


LD 


H g L 


JR 


1Z,30C4H 


LD 


H,L 


LD 


A,C 


LD 


H,D 


LD 


L,A 


LD 


H,C 


LD 


(HL),D 


LD 


H.,H 


JH 


MZ f Z30A6H 


LD 


B 9 E 


LD 


B,D 


JR 


MZ 9 30D8H 


LD 


H ? L 


LD 


(HL),E 


LB 


L P C 


LD 


H,H 
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00770 


LD 


H ? L 


00780 


LD 


(HL),E 


00790 


JR 


NZ.30CFB 


00800 


LD 


(HL),H 
A,(7820H) 


00810 


LD 


00820 


LD 


A 9 B 


00830 


LD 


A,B 


00840 


LD 


A 9 B 


00850 


LD 


C,B 


00860 


DEC 


C 


00870 


WOP 




00880 Z3078H 


LD 


D,H 


00890 


LD 


L,B 


00900 


LD 


H,L 


00910 


JR 


NZ ? 30F3H 


00920 


LD 


L,C 


00930 


LD 


H,H 


00940 


LD 


H S L 


00950 


LD 


L f A 


00960 


JR 


NZ.30C7H 


00970 


LD 


B ? E 


00980 


LD 


B,D 


00990 


JR 


NZ.30F9H 


01000 


LD 


H f L 


01010 


LD 


(HL),E 


01020 


LD 


L f C 


01030 


LD 


H 9 H 


01040 


LD 


H,L 


01050 


LD 


(HL) f E 


01060 


JR 


MZ ? 30F0H 


01070 


LD 


(HL) f H 


01080 


LD 


A,(7820H) 


01090 


LD 


A,B 


01100 


LD 


A f B 


01110 


LD 


A 9 B 


01120 


LD 


C,B 


01130 


DEC 


C 


01140 


NOP 




01150 Z3099H 


LD 


D,H 


01160 


LD 


L,B 


01170 


LD 


H,L 


01180 


JR 


NZ.310EH 


01190 


LD 


(HL),D 


01200 


LD 


L,C 


01210 


LD 


L f (HL) 


01220 


LD 


CHL),H 


01230 


LD 


H,L 


01240 


LD 


(HL),D 


01250 


JR 


NZ.30EAH 
B,E 


01260 


LD 


01270 


LD 


B P D 


01280 


JR 


NZ.311CH 


01290 


LD 


H,L 


01300 


LD 


(HL).E 



[ 



■n 



01310 


LD 


L,C 


01320 


LD 


H . H 


01330 


LD 


H f I. 


01340 


LD 


(HL) ,F. 


01350 


JR 


NZ, 31 13H 


01360 


LD 


(HL),H 


01370 


LD 


A,(7820H) 


ouao 


LD 


A ? B 


01390 


LD 


A,B 


01400 


LD 


A,B 


01410 


LD 


C,B 


01420 


DEC 


C 


01430 


NOP 




01440 


END 


3000H 



Notice that the source code here is the same at the original 
source code of "TEST/CMD" except that the labels are different 
and the text message now appears as Z-80 instructions . Text 
messages are generally easy to convert from Z-80 instructions 
back to text. This is done by converting the instructions to 
numbers. Anyone who has hand assembled a program has done this. 
The only problem exists when spaces are present in the text. The 
code for a space is 20H, which also happens to be the Z-80 
instruction for a "JR NZ ? e". The problem does not exist in 
finding the space, but in finding the character after the space. 
The character after the space is the index of the relative jump 
minus two. 

To determine the character after the space (or JR NZ) at line 
00610 do the following: 

Start counting instructions starting at the last known address. 
In this case the last know address is 3056 (or Z3056H - TASMON 
simply puts a "Z" in front of the address when making it a 
label). By doing this it is determined that the address of the 
JR NZ,30C4H instruction in line 00610 is 3057* We add one to the 
last known address because instructions such as "LD D,H" are only 
one byte long. however, if a !! JR NZ,e" instruction is 
encountered, two must be added to the address since this 
instruction is two bytes long. 

Mow subtract 3057 from 30C4 or more generally, subtract the 
address of the jump instruction from the destination of the jump. 
The result of this subtraction in our case is 6DH. 

Now subtract two more from this value. This subraction is 
necessary since the index of a relative jump is stored in memory 
as the index minus two. Subtracting two from 6DH gives 6BH f 
which is an ASCII "k". See line 570 of the first program listing 
in session 2. 

The instructions such as "LD C,B" must be converted back to ASCII 
by refering to the Z-80 instruction tables in a book such as 
Radio Shack's TRS-80 ASSEMBLY LANGUAGE PROGRAMMING. 
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It is also important to note that sow© labels were not generated ^ 

because the address that they reference contains the second or ■ 

third byte of an instruction, in this ease a LD A,(7820H) ™ 

instruction. To resolve these references, put the label in front 

of the LD A,(7820H) and change the reference from "label" to * 

"label^" . This will make the reference refer to the correct 

address, even though the label is off* 

An easier way to fix messages is to view the program with an 
ASCII dump from TASMON and record the addresses of the text 
messages. If a printer is available, pressing the "*" key will 
dump the screen contents to the printer thus giving a hardcopy 
listing of the ASCII dump 9 



In this example TASMON must reside in memory from E000-FFFF. It 
must also be protected, so from TRSDOS type; 



SESSION 4 • TRACE A BASIC* PROGRAM [| 

MEMORY (HIGH a X'DFFF 8 ) <ENTER> 

Now load TASMON from disk* If TASMON is not already located at [|| 

Eooo-FFFF, move it there with the X command as described earlier. ■■ 
How set RESTARTS to "executed in full" mode by pressing the "J" 

i 



key until you see the backslash: 

J ! 

Next load BASIC by typing; 



L <ENTER> -, 

BASIC/ CMP. BASIC || 

2TAAA BBBB CCCC"" ™ 

AAAA, BBBB, and CCCC are the starting, ending, and execution ||| 

addresses, respectively, of BASIC. Now set the PC to CCCC by ■ 

Ik 



typing; 
R PC CCCC 



and start the TRACE by typing; 

T ! 
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The initialization routine for BASIC is now being traced^ The |L 



speed of initialization can be sped up by pressing the "7" key. 

ong initialization process, the READY message will .■. 

We are now tracing through BASIC. Enter the following || 



After a long initialization process, theREADYmessage^will 

appear. 

program; 



M 
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10 PRINT » START" 

30"PRINT irr/2; 1*2 
TQ- NEXT I 
50 PRINT " DONE" 
WTMW " 

Now type: 

LIST 

The BASIC program should list upon the screen. Notice that 
TASMON is continually redisplaying the registers* This short 
program may even be RUN from TASMON ? s TRACE mode. 

If a BASIC error occurs, TASMON will be exited completely . To 

fix this condition a breakpoint must be set at 5920* Do this by 

entering: 

B 2 5920 

To exit BASIC and return to TASHON press the BREAK key. This 
must be done before any TASMON command may be entered . 

The breakpoint at 5920 will occasionally cause TASMON to be 

reentered* To continue stepping BASIC simply restart tracing as 
follows: 

1 1 

If a BASIC program being run is to be halted and control returned 
to the BASIC command mode, press the BREAK key and change the PC 
register to 5920 as follows: 

R PC 5920 

Then continue tracing* 

Let ? s start with a fresh screen by pressing the CLEAR key* 

Now start tracing BASIC if not already doing so. 

List the program again by typing: 

LIST 

The program should list on the screen . 

To RUN the program type: 

RUN 



3" III 

The message »«START M will be printed on the screen followed by ^ 

five rows of three numbers and the W END" message. [M 

! 



i 
I 

1 

i 

i 
1 
n 

1 

h 
1 
1 

1 

I 
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ftPPliiil A - B©S ERROR MESSH6ES 



Error number Error description 

00 No error 

01 Parity error during header read 

02 Seek error during read 

03 Lost data during read 

04 Parity error during read 

05 Data record not found during read 

06 Attempt to read system data record 

07 Attempt to read system data record 

08 Device not available 

09 Parity error during header yrite 
0A Seek error during write 

0B Lost data during write 

0C Parity error during write 

0D Data record not found during write 

0E Write fault on disk drive 

OF Write protected diskette 

10 Illegal logical file number (bad DCB) 

11 Directory read error 

12 Directory write error 

13 Illegal file name (bad DCB) 

14 GIT read error 

15 GIT write error 

16 HIT read error 

17 HIT write error 

18 File not In directory 

19 File access denied 
1A Directory space full 
1B Disk space full 

1C EOF encountered 

1D iHF out of file range 

1E Full directory 

1F Program not found 

20 Illegal drive number 

21 No device space available 

22 Load file format error 

23 Memory fault 

24 Attempt to load to ROM 

25 Illegal access attempted 

26 File has not been opened 
27-3E Not defined 

3F Unknown error code 
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APPENDIX B - TAiMON COMMAND SUMMARV 

This notation is used in the command summary 



HH z 4 digit hex value 

SS = 4 digit hex starting point 

EE = 4 digit hex ending point 

TT = 4 digit hex transfer point 

n s Single digit from 1 to 9 

h = 2 digit hex value 



A SS 

B n HH 

B <ENTER> 

C n 

C <ENTER> 

D SS 

E <ENTER> 

F SS h h h h 

G HH 

G <ENTER> 

H SS 

I 

J (I or !) 

K SS 

K <ENTER> 

K Y 
K N 



ASCII dump of memory starting at SS* 

Set breakpoint n at HH B 

Display the breakpoints. 

Clear breakpoint n* 

Clear all breakpoints* 

Disassemble memory starting at SS* 

Exit TASMON and return to DOS or 
BASIC 

Find search key h h h h starting 

at SS* 

Start execution at HH* 

Start execution at user's PC* 

Dump memory in hex starting at SS« 

Single step - CALLs stepped through. 

Toggle RESTARTS between stepped 

through and execute in full* 

Set user's screen buffer at SS and 
clear the screen buffer., 

Display the user's screen for as 
long as the ENTER key is held down. 

Turn the KEEP SCREEN command on. 
Turn the KEEP SCREEN command off* 
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L <offset> 
M H SS 
M A SS 
N n h 

N I 

N <ENTEH> 

SS EE TT 

P SS EE 

R rp HH 
S H1 H2 + 
S H1 H2 - 
T I 

T ! 



W SS EE TT 

X SS EE TT 
Y SS EE TT 



Load in CMD disk file named ff file" 
w:H'Ji ^11 optional offset. 

Modify memory in hex mode starting at 



Modify memory In ASCII mode starting 

d <> um „ 

Set number of executions for breakpoint 

ii to h. 

Initialize all execution numbers to 01. 

fieuet ail execution numbers to 
the;lr default values. 

Output disassembled listing 
starting at SS, ending at EE with a 
transfer address of TT to disk with the 
file name "file". 

Disassemble to the printer starting 
at 33 and ending at EE. 

Replace register pair "rp" with HH 9 

Add H2 to H1 . 

Subtract H2 from H1 . 

Trace through a program with CALLs 
stepped through. 

Trace through a program with CALLs 

executed in full. 

Go to user routine* Does nothing unless 

a routine is patched in. 

View the disk file titled "file 11 * 
Returns file starting f ending and 
transfer addresses without loading into 

memory . 

Write a CMD disk file starting at SS ? 
ending at EE with a transfer address 
of TT and file name of "file". 

Relocate memory from SS to EE and 
place it in memory starting at TT. 

Block move from SS to EE and place in 

memory starting at TT e 
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Z SS EE h 
RT ARROW 

LFT ARROW 



DN ARROW 



SHIFT-CLEAR KEY 



BREAK KEY 



Set memory from SS to EE equal to h. 

Skip current instruction in user ? s PC 

and' point to next instruction. 

Back up user's PC to the previous 

instruction* 

Dump screen contents to the printer. 

1) Single step - CALLs executed in full 

2) Display next line of a memory dump 

3) Point to next byte when modifying 

memory 

Clear the screen and display the 

registers* 

Return to command mode* 



i 
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This appendix will give an example of patching In a USER command 
(the "U" command). This routine will allow HARD COPY TRACING and 
DISPLAY THE LAST FIFTEEN EXECUTED INSTRUCTIONS. 

HARD COPY TRACING is the same as normal tracing except the 
current PC address and Z-80 mnemonic are sent to the printer. If 
the printer is not on when "HAND COPY TRACE 11 is selected , nothing 
Is printed and execution continues as If the TRACE command had 
been selected* 

DISPLAY THE LAST FIFTEEN EXECUTED INSTRUCTIONS while tracing will 

display the user s s PC and Z-80 mnemonic on TASMON's display 
lines. 



This patched routine assumes that TASMQN4 version 1,00 is being 
used, AlsOj, TISMON should be located in memory starting at 
E000H* The following bytes are entered: 



M H FD6F 6D 


























and enter the following 


bytes 


from ' 


zheret 














FD6F: 


00 00 CD 32 E9 


CD 


EC EO 


FE 


44 


28 


OB 


FE 


48 


28 


46 


FE 


55 


FD81: 


CA F7 E0 18 EE 


CD 


32 E9 


32 


30 


FE 


C3 


43 


E8 


AF 


32 


2F 


FE 


FD93: 


32 30 FE C3 3E 


EO 


3A 30 


FE 


B7 


28 


22 


CD 


23 


E9 


2A 


42 


F8 


FDA5* 


CD 37 F1 3E 20 


CD 


32 E9 


21 


38 


00 


06 


11 


E5 


C5 


06 


01 


3E 


FDB7: 


OF EF CD 94 F7 


C1 


E1 23 


10 


F1 


3A 


El 


F8 


C9 


CD 


32 


E9 


32 


FDC9: 


2F FE C3 43 E8 


3A 


2F FE 


B7 


CA 


03 


E1 


E5 


D5 


1E 


50 


16 


52 


FDDB: 


3E 52 EF EB 0E 


00 


3E 05 


EF 


D1 


E1 


C2 


03 


E1 


2A 


42 


F8 


7C 


FDED; 


CD 15 FE 7D CD 


15 


FE 3E 


20 


CD 


A3 


F7 


CD 


03 


E1 


06 


14 


21 


FDFF^ 


38 00 E5 C5 06 


01 


3E OF 


EF 


CD 


A3 


F7 


C1 


E1 


23 


10 


F1 


3E 


FE11: 


OD C3 A3 F7 F5 


CB 


3F CB 


3F 


CB 


3F 


CB 


3F 


CD 


24 


FE 


F1 


E6 


FE23 


OF C6 30 FE 3A 


38 


02 Co 


07 


C3 


A3 


■F7 


00 


00 










MODIFY MEMORY in hex 


as 


follows. 




















M H E0E7 71 6C 


























E0E8 


1 EO FD 


























E0E9 


C3 <BREAK> 



























M H E732 CE £9 
E733 f E1 FD 
E734 D1 <BREAK> 

M H E868 : 3A CD 
E869 CC 99 
E86A F8 FD 

E86B B7 <BREAK> 

NOTE: DO NOT hit the BREAK key to exit from this last memory 
modification until the correct values are in place. Failure to 
do this will probably cause a reset! 



40 



■ 



M h E101 4 3E XI 
E102 ? EO FD 
E103 : 3A TBREAiP 

To write the patched version of TASMON out under the file name 
"UPTASMON/CMD", enter the following command: 

W E0O0 FFFF EOOO 
UPTX5E0¥7CMD m TEMTER> 

To execute the "HARD COPY TRACE" command, press the "U" key I 
followed by the "H" key for HARD COPY TRACE. Next, enter the 

CALL stepping mode* This is an "I" for CALLs stepped through or m n 

a DOWN ARROW for CALLs executed in full. I|| 

TASMON will step through memory as it would with the TRACE 

command except the following type output is sent to the printers | 

8000 LD A,(37E8) 

All TRACE command keys function with the "HARD COPY TRACE" patch* ||| 

The DISPLAY LAST FIFTEEN EXECUTED INSTRUCTIONS patch is executed fc 

by pressing the "U" key and the "D" key for DISPLAY LAST FIFTEEN II] 

EXECUTED INSTRUCTIONS^ Next, enter the CALL stepping mode. This ™ 
is an "I" for CALLs stepped through or a DOWN ARROW for CALLs 

executed in full. Kii 

After each instruction is executed, its address and Z-80 mnemonic 

are displayed on TASM0N f s command lines* Up to sixteen k., 

previously executed instructions will be displayed. ||| 

All TRACE command keys function with the "DISPLAY LAST FIFTEEN 

EXECUTED INSTRUCTIONS" routines If] 

This patch may be in a different location for either past or 

future versions of TASMON* Any future version may have these ■■ 

commands added to its repertoire. Ill 

If even more user routines are to be added, the address at FD7D- *„ 

FD7E can be modified to the starting address of the new routine. I|| 
To execute this routine press the "U" key to jump to this user 

patch and another "U" to jump to the new routine. _ 

i 
i 
i 
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MODEL m T iSMOi TECHNICAL NOTES 



Model IV TASMON was written in such a way as to be as 
functionally compatible with the Model I/III versions as 
possible. There are a few quirks, though, that the Model IV user 
should be aware of. 

First of all, tape support has been eliminated . The reason for 
this should be obvious. 

Logical Systems, Inc., the authors of TRSDOS 6 x, obviously don't 
want people fooling around with the system, but rather than 
sacrifice the power that TASMON had in order to accede to LSI 
imperatives, we elected to ignore their warnings about tampering 
with the system at the hardware level and implement the same 
features that were in the Model I/III versions of TASMON* 

Scrolling was a problem. TASMON scrolls the area directly 
underneath the register display while maintaining the display. 
The video control SVC's were simply not flexible enough to allow 
this to happen. 

The "keep screen" feature was another tricky one. There ARE 
SVC ! s to move the screen to/from a 2K buffer , and I used those. 

The problem, then, was viewing the kept screen. Ideally, it had 
to be identical to the Model I/III technique in which the user 
simply typed "K" and held down the <ENTER> key for as long as 
they wanted to see the screen, In order to do this, though, I 
had to access the keyboard directly - another LSI no no. Again, 
rather than sacrifice the keep screen capability, I wrote the 
code to access the keyboard as necessary. i 9 e 8 „ directly, rather 
than through a SVC. 

Since this code is very system dependent* and might have to 
change as TRSDOS 6.x changes (unlikely - it f s not THAT system 
dependent!) we elected to put the code in an overlay* 

Another reason for using the overlay is that the code there 
toggles the high RAM bank in and out, and if this code were in 
TASMON itself and TASMON were in the upper 32K of RAM, in the 
process of toggling high RAM back and forth, TASMON would toggle 
itself right out of existence! The solution to this problem was 
to make the code part of an overlay and to make it self- 
contained, i.e., no referrences to addresses within TASMON, and 
to have its own stack. If you examine the overlay code, you will 
see how this has been accomplished. 

There is a drawback to using an overlay to do TASMON s s scrolling* 
You cannot trace or single-step through any RST 28H that calls in 
a DOS overlay, since to do so would mean that the DOS would load 
its overlay; TASMON would load ITS overlay on the next call to 
the scrolling routine; the DOS, not being aware that its overlay 
was no longer in place, would try to execute TASMON f s overlay; 
and massive amounts of chaos would exist* So, don ? t trace or 
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single-step RST 28H unless you know for a fact that the RST will 
not load a DOS overlay* 



Paul F. Snively 



PATCHES TO CHANGE CERTAIN CHARACTERISTICS OF TASMON 

These patches are optional and may be applied as desired to your working copy of TASMON, They 
may be applied in memory only, in which case they will remain in effect unbl the end of your sessu.-' 
with TASMON, or you may use TASMON's W D command to write a copy of your patched TASMOJT 

disk* 

PLEASE NOTE that these patches apply only to the following versions of TASMON, however- 
information is given to allow you to find the proper location to apply the patch if you have another 
version* 

MODEL i: VERSION 2,22 MODEL III: VERSION D7 MODEL 4! VERSION 1,11 

PATCH # 1 - CHANGE FIRST CHARACTER OF LABELS DURING DISASSEMBLY, 

Using TASMON's M A (Modify memory using ASCII) command, change the following byte from the 
letter "Z" (5AH) to the desired first character for labels! 

MODEL It 7486H MODEL IIIJ 748AH MODEL 45 F436H 

If you have a different version of TASMON, key in F nnnn 3E 5A (where nnnn is normally 6000H in 
the Models I & III, and EOOOH in the Model 4), The displayed address PLUS ONE is the byte to 
change, 

PATCH # 2 - REMOVE 7-BYTE "HEADER" FROM DISASSEMBLIES TO DISK, 

TASMON was written to output disassembled source code that could be loaded directly into 
Apparat's modified version of the Radio Shack Editor-Assembler program (as found on NEWDOS/SO 
master disks), Most Editor-Assembler programs are able to read this source code format, but some 
(notably Radio Shack's Series I) will not read these source code files because of the seven-byte 
"header" that is placed at the beginning of these files, To prevent TASMON from writing this 
"header", use TASMON's M H (Modify memory) command to change two bytes starting at the 
addresses shown below, The bytes should be changed from 3E D3 to 18 19 in the Models I ffllX, and 
to 18 OC in the Model 4, This inserts a JR instruction that bypasses the code that writes the header 
to disk, Change the two bytes starting at, 

MODEL II 7312H MODEL IIIJ 731CH MODEL 45 F2EEH 

If you have a different version of TASMON, key in F nnnn 3E D3 (where nnnn is normally 6000H in 
the Models I St III, and EOOOH in the Model 4) to "find the starting address to change, 

PATCH # 3 - CHANGE AMOUNT OF KEYBOARD DEBOUNCE (MODELS I St III ONLY), 

This patch is especially useful when you are using a speed-up modification, or when running the 
Model III version of TASMON on a Model 4 using the 4 MHz 'dock speed, Using TASMON's M s 
(Modify memory) command, change the following byte from OAH to the value that «jives the desired 
amount of keybounce control, For example, to double the normal keybounce delay, change the byte to 
14H* 

MODEL IJ 7A10H MODEL IIIJ 7A53H 

If you have a different version of Model I or III TASMON, kev in F 6000 01 00 0A. The displayed 
address PLUS TWO is the byte to change, 

Patches supplied by Jack Decker, 



